Instrument Settings

The Instrument Settings screen, accessed from either the keypad or the System Menu, provides various instrument settings described in this topic.

Keypad Access

Multi-Touch Display Access from the System Menu

Instrument Information ClosedSetup

Internal Versions

I/O Configuration ClosedSetup

GPIB Address

Sockets SCPI

VXI-11 SCPI

HiSLIP SCPI

SCPI Telnet Port

Device List

Alignment

Triggers and Sync

Power On / Preset ClosedSetup

Power On State

Restore System Settings to Default

Perform Factory Preset

Reference ClosedSetup

Reference Source

Current Reference Source

Reference Source Auto

External Reference Frequency

External Reference Locking Range

Reference State

Reference Out

LF Out (100 MHz Out)

HF Out (19.2 GHz Out)

I/Q Waveform ClosedSetup

Waveform Extension Method

Default Binary File Format

Service ClosedSetup

Instrument Self Test

Channel Self Test

Status

Instrument Temperature

Thermal Safe Operating Margin

Exhaust Temperature

Channel Temperature

Utilities

Fan Control

Preferences ClosedSetup

Instrument Identification

Attenuator Compatibility Mode

Enable SCPI Development Mode

SCPI Backwards Compatibility Mode

Appearance - Color Theme

System Remote Commands ClosedSetup

SCPI Error Queue

Retrieve All Entries In The Queue

Number of Entries In The Queue

Retrieve Next Entry

Retrieve Next Entry Code

Message in the Message Queue

List installed Software Options

Lock Workstation

List SCPI Commands

Instrument start time

SCPI Version Query

Attenuator History Query

Attenuator Bypass History Query

Power On History Query

On Time History Query

Controller BIOS Query

Instrument Information

This tab brings up a display of instrument information.

The Copy button copies this information to the clipboard for pasting into Windows programs.

Some of this information is available via SCPI commands, as described in Internal Versions.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Instrument Information

Initial S/W Revision

A.01.00

Internal Versions

The instrument software contains a number of internal components. The Internal Versions displays versions of the primary internal components as determined by Keysight Technologies. The number of versions reported and the formatting may change on any given software release.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Instrument Information > Internal Versions

SCPI Command

:DIAGnostic[:CPU]:INFormation:REVision?

SCPI Example

DIAG:INF:REV?

Notes

The return value is a string. The formatting and number of versions may change in any given software release. Thus, any program using this string should be implemented in a way that does not rely on the contents in a strict manner.

Initial S/W Revision

A.01.00

Modified S/W Revision

A.04.00

Some of this information is available via SCPI commands as follows:

*IDN? - Identification Query provides Model number, Serial number, and Firmware version.

*OPT? - Query Instrument Options provides the comma separated options string.

I/O Configuration

Opens the I/O Configuration menu, which lets you display the VISA addresses, and configure GPIB, SCPI Services, and SCPI Options.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > IO Configuration

Initial S/W Revision

A.01.00

Modified S/W Revision

A.04.00

GPIB Address

Specifies the GPIB address of your instrument.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/O Configuration > Addresses tab > GPIB Address

SCPI Command

:SYSTem:COMMunicate:GPIB:ADDRess <integer>

:SYSTem:COMMunicate:GPIB:ADDRess?

SCPI Example

:SYST:COMM:GPIB:ADDR 19

Notes

Changing the Address on the GPIB port requires all further communication to use the new address.

Preset

This is unaffected by Preset but is set to 19 on a "Restore System Settings to Default Values"

State Saved

No

Range

0 to 30

Initial S/W Revision

A.01.00

Sockets SCPI

Turns the sockets server in your instrument on and off.

SCPI Command

:SYSTem:COMMunicate:SCPI:SOCKets ON|OFF|1|0

:SYSTem:COMMunicate:SCPI:SOCKets?

SCPI Example

:SYST:COMM:SCPI:SOCK ON

Preset

This is unaffected by Preset but is set to ON on a "Restore System Settings to Default Values"

State Saved

No

Initial S/W Revision

A.01.00

VXI-11 SCPI

Turns the VXI-11 server in your instrument on and off.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/O Configuration > SCPI Setup tab > VXI-11 SCPI

SCPI Command

:SYSTem:COMMunicate:SCPI:VXI11 ON|OFF|1|0

:SYSTem:COMMunicate:SCPI:VXI11?

SCPI Example

:SYST:COMM:SCPI:VXI11

Preset

This is unaffected by Preset but is set to ON on a "Restore System Settings to Default Values"

State Saved

No

Initial S/W Revision

A.01.00

HiSLIP SCPI

Turns HiSLIP in your instrument on and off.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/O Configuration > SCPI Setup tab > HiSLIP SCPI

SCPI Command

:SYSTem:COMMunicate:SCPI:HISLip ON|OFF|1|0

:SYSTem:COMMunicate:SCPI:HISLip?

SCPI Example

:SYST:COMM:SCPI:HISL

Preset

This is unaffected by Preset but is set to ON on a "Restore System Settings to Default Values"

State Saved

No

Initial S/W Revision

A.01.00

SCPI Telnet Port

The instrument provides basic SCPI I/O via a telnet port.  The default port is 5024. The ability to change the port to 5023 is provided.

NOTE: changing the SCPI Telnet Port requires restarting the instrument application for the change to take effect.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/O Configuration > Addresses tab > SCPI Telnet Port

SCPI Command

:SYSTem:COMMunicate:LAN:SCPI:TELNet:PORT 5023|5024

:SYSTem:COMMunicate:LAN:SCPI:TELNet:PORT?

SCPI Example

:SYST:COMM:LAN:SCPI:TELN:PORT 5023

Preset

Not reset by Preset, set to 5024 with Restore System Settings to Defaults.

Initial S/W Revision

A.04.00

Power On / Preset

Sets how the instrument should power on and activate certain presets.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Power On/Preset

Initial S/W Revision

A.01.00

Power On State

Selects whether the instrument powers up in a default state or some other state.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Power On/Preset > Power On State

SCPI Command

:SYSTem:PON:TYPE PRESet|USER|LAST

:SYSTem:PON:TYPE?

SCPI Example

:SYST:PON:TYPE PRES

:SYST:PON:TYPE USER

:SYST:PON:TYPE LAST

Preset

This is unaffected by a Preset but is set to Preset on a "Restore System Settings to Default Values"

State Saved

No

Initial S/W Revision

A.01.00

Restore System Settings to Default

Sets the states that are not affected by signal generator power–on, Preset, or *RST to their factory default settings.

Most settings are affected by Preset, but there are some settings that are unaffected. These are called persistent variables.  The system and each application will list its persistent variables. To reset these, select Restore System Settings to Default.

When this control is selected, the following message appears:

"This will reset all persistent variables to their default state. This action cannot be undone. Do you want to proceed?"

The message provides an OK and Cancel button to let you affirm or cancel the operation.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Power On State > Restore System Settings to Default

SCPI Command

:SYSTem:PRESet:PERSistent

SCPI Example

:SYST:PRES:PERS

Initial S/W Revision

A.01.00

Perform Factory Preset

Sets all states of the signal generator back to their factory default settings, including states that are not normally affected by signal generator power–on, Preset, or *RST.

When selected, the following message appears:

"This will reset all variables (including System variables) to their default state. This action cannot be undone. Do you want to proceed?"

The message provides an OK and Cancel button to let you affirm or cancel the operation.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Power On/Preset > Perform Factory Preset

SCPI Command

:SYSTem:PRESet:ALL

SCPI Example

:SYST:PRES:ALL

Notes

No confirmation is required when the SCPI command is sent

Initial S/W Revision

A.01.00

Reference

The Reference tab lets you configure the frequency reference for the instrument. For Option 1ER, the user interface appears and behaves differently.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference

Initial S/W Revision

A.01.00

Modified S/W Revision

A.04.00 and A.11.00

Modified S/W Revisions A.04.00, A.11.00, and A.16.00

Standard User Interface for Reference

Option 1ER User Interface for Reference

Reference Source

Sets the source for the frequency reference. Choices include the following:

The reference indicator field in the notifications bar at the bottom of the GUI displays the currently selected Reference Source and its current state.

When set to External, the frequency of the external signal can be specified with the External Reference Frequency setting.

If the external reference becomes unlocked or fails, after you correct the issue, toggle the Frequency Reference Source to Internal and back to External to update the Reference State status.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference >Reference Source

SCPI Command

[:SOURce]:ROSCillator:SOURce INTernal|EXTernal|PPS

[:SOURce]:ROSCillator:SOURce?

SCPI Example

:ROSC:SOUR EXT

:ROSC:SOUR?

Dependencies Default value of INTernal is set by Restore System Defaults.

Notes

Changing the reference may take up to 30 seconds to regain frequency lock. For remote control operation, ensure your VISA timeout is set to 30 seconds (or more) when executing this command.

With standard configuration, attempting to set PPS will raise the error "703,Feature not supported; External PPS requires Option 1ER"

Couplings

For M9383B, M9384B, M9484C:

When Reference Source is External 1 PPS, Reference Source Auto is Off and unchangeable.

State Saved Persistent, survives preset and power cycle but not saved in the instrument state.
Backwards Compatibility SCPI

E82X7D, E8663D, and N51xxB:

[:SOURce]:ROSCillator:SOURce

Backwards Compatibility Notes

For N51xxB:

SCPI query reports the setting’s stored value, not what is actively being applied to the hardware. This command differs from this prior behavior. To query what source is actively applied to hardware, see Current Reference Source setting.

Initial S/W Revision

A.01.00

Modified S/W Revision

A.11.00 - Added Option 1ER

A.16.00 - Added coupling with Reference Source Auto

Current Reference Source

Remote command only.

For M9383B, M9384B, and M9484C:

Returns the current reference source being applied to the instrument. Possible sources are:

See Reference Source setting for more information.

SCPI Command

[:SOURce]:ROSCillator:SOURce:CURRent?

SCPI Example

:ROSC:SOUR:CURR?

Initial S/W Revision

A.16.00

Reference Source Auto

For M9383B, M9384B, and M9484C:

Enables or disables the ability of the signal generator to automatically switch between the Internal and External reference oscillator.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference > Auto

SCPI Command

[:SOURce]:ROSCillator:SOURce:AUTO ON|OFF|1|0

[:SOURce]:ROSCillator:SOURce:AUTO?

SCPI Example

:ROSC:SOUR:AUTO ON

:ROSC:SOUR:AUTO?

Dependencies Default value of OFF is set by Restore System Defaults
Notes Changing the reference may take up to 30 seconds to regain frequency lock. For remote control operation, ensure your VISA timeout is set to 30 seconds (or more) when executing this command.
Couplings

For instruments with Option 1ER:

When Reference Source is set to External 1 PPS, Auto is off and unchangeable. Attempting to enable will raise the error -221,“Settings Conflict; Cannot enable Auto while Reference Source is External 1 Pulse Per Second”.

State Saved Persistent, survives preset and power cycle but not saved in the instrument state.

Initial S/W Revision

A.16.00

External Reference Frequency

For M9383B/M9384B/M9484C, the frequency of the external reference can be 10 MHz or 100 MHz. Additionally, with Option 1ER, the frequency can be 1 MHz to 110 MHz with 0.1 Hz resolution.

After changing the External Reference Frequency, wait up to 30 seconds for the instrument’s frequency to settle.

[GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference > External Reference Frequency

SCPI Command

[:SOURce]:ROSCillator:FREQuency:EXTernal <freq>

[:SOURce]:ROSCillator:FREQuency:EXTernal?

SCPI Example

:ROSC:FREQ:EXT 100 MHZ

Preset

This is unaffected by a Preset but is set to 10 MHz on a "Restore System Settings to Default Values."

State Saved

Persistent, survives preset and power cycle but not saved in the instrument state.

Notes

Changing the reference frequency may take up to 30 seconds to regain frequency lock.  For remote control operation, ensure your VISA timeout is set to 30 seconds (or more) when executing this command.

For M9383B/M9384B/M9484C

  • With standard configuration, the valid selections for <freq> are 10 MHz or 100 MHz. Any other value will generate the error "-221,Settings conflict" "703,Feature not supported; frequency value requires Option 1ER"

  • When Frequency Reference is set to PPS, attempting to change frequency value will raise the error "-221, Settings conflict; frequency value cannot be changed while set to External 1 PPS"

Min

For M9383B/M9384B/M9484C

  • With standard configuration: 10 MHz

  • With Option 1ER: 1 MHz

Max

For M9383B/M9384B/M9484C

  • With standard configuration: 100 MHz

  • With Option 1ER: 110 MHz

Resolution

For M9383B/M9384B/M9484C

  • With standard configuration: Not applicable

  • With Option 1ER: 0.1 Hz

Initial S/W Revision

A.04.00

Modified S/W Revision

A.11.00 - Added Option 1ER

External Reference Locking Range

The instrument provides two locking ranges for an externally supplied reference signal. Locking range set to Wide allows your reference signal to be further away in frequency from the selected value in External Reference Frequency, with a slight compromise in the phase noise performance of the instrument. Locking range set to Narrow provides the best phase noise on the instrument, however, the reference signal must closer in value to the external reference frequency setting. See table below.

Locking Range

External Reference Requirements

Benefits

Wide

Within approximately +/- 1.0 ppm of the selected external reference frequency

Easier to lock to external reference

Narrow

Within approximately +/- 0.6 ppm of the selected external reference frequency

Better phase noise

[GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference > External Reference Locking Range

SCPI Command

[:SOURce]:ROSCillator:FREQuency:EXTernal:LRANge NARRow|WIDE

[:SOURce]:ROSCillator:FREQuency:EXTernal:LRANge?

SCPI Example

:ROSC:FREQ:EXT:LRAN WIDE

Preset

For M9383B/M9384B:

This is unaffected by a Preset but is set to NARRow on a "Restore System Settings to Default Values."

For M9484C:

This is unaffected by a Preset but is set to WIDE on a "Restore System Settings to Default Values."

State Saved

Persistent, survives preset and power cycle but not saved in the instrument state.

Notes

For M9383B/M9384B:

Beginning with S/W revision A.07.00 the default setting is NARRow, prior to A.07.00 the instrument was configured for NARRow and not changeable.

Initial S/W Revision

A.07.00

Reference State

Displays the current state of the frequency reference. The displayed state can help you understand whether the frequency reference is locked or if a failure occurred.

See Notifications Area for more information on various Reference states.

If the external reference becomes unlocked or fails, after you correct the issue, toggle the Frequency Reference Source to Internal and back to External to update the Reference State status.

Reference Out

The 10 MHz Out connector is normally on, providing a 10 MHz frequency reference by default. The connector can be switched off.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference > Reference Out

SCPI Command

:ROUTe[:CONNectors]:REFerence:ROUTput OFF|F10

:ROUTe[:CONNectors]:REFerence:ROUTput?

SCPI Example

ROUT:REF:ROUT OFF

Notes

For M9383B, M9384B, and M9484C:

Can be F10 (10 MHz) or OFF. Attempting other selections on these models will raise the error 703,"Feature not supported; Reference Output frequency not changeable on this instrument."

Preset

This is unaffected by a Preset but is set to 10 MHz on a "Restore System Settings to Default Values."

State Saved

Persistent, survives preset and power cycle but not saved in the instrument state.

Initial S/W Revision

A.13.00

LF Out (100 MHz Out)

For M9383B or M9384B, when checked this turns on the 100 MHz Out reference output signal. Leave this unchecked if you are not using this output, to minimize emissions.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference > 100 MHz Out

SCPI Command

:ROUTe[:CONNectors]:REFerence:LFOutput:STATe ON|OFF|1|0

:ROUTe[:CONNectors]:REFerence:LFOutput:STATe?

Notes

For models other than M9383B or M9384B the setting is accepted with no error raised.

Preset

On

Initial S/W Revision

A.01.00

HF Out (19.2 GHz Out)

For M9383B or M9384B, when checked this turns on the 19.2 GHz Out reference output signal. Leave this unchecked if you are not using this output, to minimize emissions.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Reference > 19.2 GHz Out

SCPI Command

:ROUTe[:CONNectors]:REFerence:HFOutput:STATe ON|OFF|1|0

:ROUTe[:CONNectors]:REFerence:HFOutput:STATe?

Notes

For models other than M9383B or M9384B the setting is accepted with no error raised.

Preset

Off

Initial S/W Revision

A.01.00

I/Q Waveform

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/Q Waveform

Initial S/W Revision

A.06.00

Waveform Extension Method

The instrument requires waveforms to be a multiple of 8 samples, and a minimum of 512 samples. You can choose how the instrument processes waveforms that do not match the instrument’s requirements as follows:

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/Q Waveform > Waveform Extension Method

SCPI Command

:MEMory:IMPort:WEXTension NONE|WARN|REPeat|ZPADding

:MEMory:IMPort:WEXTension?

SCPI Example

:MEM:IMP:WEXT REP

:MEM:IMP:WEXT?

Preset

This is unaffected by a preset, but is set to REPeat on a "Restore System Settings to Default Values"

State Saved

Persistent, survives preset and power cycle but not saved in the instrument state.

Choices

None | Warn | Repeat | Zero Padding

Initial S/W Revision

A.04.00

Default Binary File Format

Sets the default binary file format used when reading waveform binary files. This affects simple binary data only and does not affect other formats such as secure waveform (wfm) file and Matlab file.

Selections are:

This setting does not affect the data currently selected. For example, if a binary file is selected by the File setting under Signal’s Waveform File mode, changing this setting doesn’t invoke reloading or reuploading of the file. The selected new file format is used when the file is set next time.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > I/Q Waveform > Default Binary File Format

SCPI Command

:SYSTem:WAVeform:BFILe:FORMat:DEFault I16Big|I16Little

:SYSTem:WAVeform:BFILe:FORMat:DEFault?

SCPI Example

:SYST:WAV:BFIL:FORM:DEF I16B

Preset

I16Big

State Saved

Persistent, survives preset and power cycle but not saved in the instrument state.

Choices

Int16 Big Endian | Int16 Little Endian

Initial S/W Revision

A.06.00

Service

Accesses capabilities performed in the factory or under instructions from repair procedures.

Diagnostics

This area accesses self test and other diagnostic functions.

Pressing "Copy" copies this information to the Clipboard for pasting into Windows programs.

Instrument Self Test

Selecting Self Test followed by Run Self Test displays diagnostic information for the installed modules. View Closedexample image.

For information on running the self test from SCPI see *TST? - Self Test Query

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Self Test

Initial S/W Revision

A.01.00

Modified S/W Revision

A.11.50 Updated for M9484C

Run Self Test takes at least five minutes to complete.

Copy simply copies this information to the clipboard for pasting into Windows programs.

Channel Self Test

Remote Command only.

This query performs the internal self-test routines for a specified RF Channel and returns a number indicating the success of the testing. A zero is returned if the test is successful, 1 if it fails.

SCPI Command

:SYSTem:RF<channel>:STESt?

SCPI Example

SYST:RF3:STESt?

!Runs the self-test routines for RF Channel 3 and returns 0=passed, 1=some part failed.

Notes

SYSTem:RF<channel>:STESt? May take many minutes to complete, set timeout value on controlling test program to a very large value (e.g. 10 minutes).

Successful completion of self-test on the channel will clear the applicable bit in the STATus:QUEStionable:STFailed or STATus:QUEStionable:STFailed:ESTFailed register. Unsuccessful completion of self-test on the channel will set the applicable bit in the STATus:QUEStionable:STFailed or STATus:QUEStionable:STFailed:ESTFailed register.

Initial S/W Revision

A.11.50

Status

The Status tab displays temperatures and other information for the installed modules when you click Update.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Status

Initial S/W Revision

A.01.00

Modified S/W Revisions

A.11.50 - Updated for M9484C

A.15.09 - Added Exhaust Temperature reporting

Copy simply copies this information to the clipboard for pasting into Windows programs.

Instrument Temperature

The instrument’s temperature is provided in the Service > Status screen when you click Update. It is also available via a SCPI query.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Status

SCPI Command

:SYSTem:TEMPerature?

SCPI Example

SYST:TEMP?

Notes

Value returned is in degrees Celsius.

Initial S/W Revision

A.14.00

Thermal Safe Operating Margin

The instrument maintains proper instrument operation with the Fan Control set to Auto for the specified environmental conditions. If the instrument’s temperature becomes excessive, it may shutdown. Thermal safe operating margin allows you to observe how close the current temperature is to the safety limit.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Status

SCPI Command

:SYSTem:TEMPerature:OMARgin?

SCPI Example

SYST:TEMP:OMAR?

Notes

Value returned is in degrees Celsius.

Initial S/W Revision

A.14.00

Exhaust Temperature

The instrument's airflow temperature is reported in the Service > Status tab. It is also available via a SCPI query.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Status

SCPI Command

:SYSTem:TEMPerature:EXHaust?

SCPI Example

SYST:TEMP:EXH?

Notes

Value returned is in degrees Celsius.

Initial S/W Revision

A.15.09

Channel Temperature

When monitoring the instrument’s temperature it is recommended to use the Instrument Temperature. For instruments with more than 1 channel, the ability to query an individual channel’s temperature is provided should you desire to monitor an individual channel.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Status

SCPI Command

:SYSTem:RF<channel>:TEMPerature?

SCPI Example

SYST:RF2:TEMP?

Notes

Value returned is in degrees Celsius.

If the indicated <channel> doesn’t exist on the instrument, a timeout will occur. Ensure that you use this query only on the available channels of the instrument.

Initial S/W Revision

A.14.00

Utilities

Selecting Utilities displays the available utilities for the installed modules.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Utilities

Initial S/W Revision

A.14.00

Fan Control

By default, the instrument dynamically adjusts the fan speed to provide the appropriate cooling for specified environmental conditions. You can override this automatic control by setting the fan to the maximum speed, in the event your environmental conditions are extreme.

If you set the fan to the maximum speed, it results in the loudest instrument operation.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Service > Utilities

SCPI Command

:SYSTem:FCONtrol AUTO|MAXimum

:SYSTem:FCONtrol?

SCPI Example

SYST:FCON MAX

Setup

:SYSTem:PRESet:PERSistent

Post Setup :SYSTem:PRESet:PERSistent

Dependencies

Default value of AUTO is set by Restore System Defaults

State Saved

Persistent, survives preset and power cycle but not saved in the instrument state.

Initial S/W Revision

A.14.00

Preferences

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Preferences

Initial S/W Revision

A.01.00

Instrument Identification

The instrument is delivered from the factory with the Model Number, Instrument Description, and the Serial Number. The M9383B, however, does not have a serial number. For the M9383B and M9384B, there may be situations where the identification needs to be changed, such as if you are using a removable SSD and sharing a spare SSD between different VXG signal generators. You can change the Model Number and Serial Number in the Preferences tab in the System menu. The Description will be automatically selected based on Model Number.

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Preferences > Instrument Identification

Initial S/W Revision

A.04.00

Attenuator Compatibility Mode

Remote command only.

Configures the Attenuator Compatibility Mode. When in PSG mode, the coupling among Power, Attenuation, and ALC Level works in a similar way as the PSG. With this coupling, the Power is changed when the ALC Level is changed. In the VXG, Power is not clipped when the ALC Level goes to either max or min.

SCPI Command

:SYSTem:COMPatibility:POWer:ATTenuator NORMal|PSG

:SYSTem:COMPatibility:POWer:ATTenuator?

SCPI Example

SYST:COMP:POW:ATT PSG

SYST:COMP:POW:ATT?

Notes

The setting is enabled by this command is not affected by signal generator power-on, preset, or *RST.

Preset

NORMal

State Saved

No

Initial S/W Revision

A.04.00

The following example shows how Power, Attenuation, and ALC Level change when Attenuator Compatibility Mode is PSG.

# Set Attenuator Compatibility Mode to PSG

-> :SYSTem:COMPatibility:POWer:ATTenuator PSG

# Set up the initial condition. ALC Level is set based on

-> :POWer -10dBm

-> :POWer:ATTenuation:AUTO OFF

-> :POWer:ATTenuation?

<- 0

-> :POWer:ALC:LEVel?

<- -10

# Increasing ATTen by 10 dB decreases Power by the same amount

# -20 dBm (= ALC Level - Atten)

-> :POWer:ATTenuation 10.0 dB

-> :POWer?

<- -20

-> :POWer:ALC:LEVel?

<- -10

# Change ALC Level changes Power

-> :POWer:ALC:LEVel -9 dBm

-> :POWer?

<- -19

# When Auto Atten is on (Atten Hold off), the equation

#  Power = ALC Level - Atten

# doesn't hold.

# Note that Atten 70 dB in this example isn’t the actual Atten value.

# In VXG, the actual one is set only when Auto Atten is off. 

-> :POWer:ATTenuation:AUTO ON

-> :POWer?

<- -19

-> :POWer:ATTenuation?

<- 70

-> :POWer:ALC:LEVel?

<- -9

# Changing Power doesn't change Atten nor ALC Level

-> :POWer -17.0 dBm

-> :POWer:ATTenuation?

<- 70

-> :POWer:ALC:LEVel?

<- -9

# When AUTO is off again, Atten and ALC Level are set to satisfy the equation.

#  Power = ALC Level - Atten

-> :POWer:ATTenuation:AUTO OFF

-> :POWer?

<- -19

-> :POWer:ATTenuation?

<- 0

-> :POWer:ALC:LEVel?

<- -19

# When Power changes by a large amount, ALC Level exceeds the limit.

# In PSG, the both the power and ALC Level are clipped.

# On the other hand, in VXG, only ALC Level is clipped.

-> :POWer -37.0 dBm

-> :POWer:ATTenuation?

<- 0

-> :POWer:ALC:LEVel?

<- -20

-> :POWer?

<- -37

-> :SYST:ERR?

<- -222,"Data out of range;ALC Level value clipped to lower limit -20 dBm."

Enable SCPI Development Mode

When the instrument is in remote operation, a message box appears on the screen to notify the operator that an external program is controlling the instrument.  In some situations, such as during development of SCPI programs, you may want to see the full instrument screen.  This SCPI command is available to suppress the on-screen remote operation notification.

When using this command to suppress the remote operation notification, be aware that the front panel becomes responsive to touch and remote GUI operation.

SCPI Command

:DISPlay:DEVelopment ON|OFF|1|0

:DISPlay:DEVelopment?

SCPI Example

DISP:DEV ON

Preset

Not affected by Preset, not a System Setting.  Set to OFF upon startup of the instrument.

State Saved

No

Initial S/W Revision

A.14.00

SCPI Backwards Compatibility Mode

Remote command only.

Optimizes SCPI backwards compatibility with legacy products by coercing queries to return deprecated values.

Mixing legacy SCPI commands with current commands is not recommended.

SCPI Command

:SYSTem:COMPatibility:MODE E82X7D|E8663D|N51XXB|NONE

:SYSTem:COMPatibility:MODE?

SCPI Example

:SYST:COMP:MODE N51XXB

:SYST:COMP:MODE?

Notes

SCPI commands of all supported forms are accepted, but query values will be formed to the selected compatibility when present.

Preset

None

Range E82x7D|E8663D|N51xxB

State Saved

Yes

Backwards Compatibility SCPI

Alias SYST:COMP:MODE MXGB to SYST:COMP:MODE N51XXB

Alias SYST:COMP:MODE PSGD to SYST:COMP:MODE E82X7D

Initial S/W Revision

A.15.00

Appearance - Color Theme

Bright Color (LIGHt) – Selects a full color palette for the display with dark text on a bright background.

Dark Color (DARK) – Selects a full color palette for the display with bright text on a dark background

GUI Location

System Menu (triple bar icon) > Settings (gear icon) > Preferences > Color Theme

SCPI Command

:DISPlay:THEMe DARK|LIGHt

:DISPlay:THEMe?

SCPI Example

SYST:DISP:THEM DARK

State Saved

Power On Persistent (survives shutdown and restart)

Preset

This is unaffected by a Preset but is set to DARK on a "Restore System Settings to Default Values"

Initial S/W Revision

A.04.00

System Remote Commands

Remote commands only.

The commands in this section have no front-panel key equivalent.

SCPI Error Queue

The signal generator instrument provides the remote operation error queue as defined in IEEE SCPI standard version 1999.

Items in the SCPI Error queue are from remote operations. These are separate from the errors generated from front panel operations (see Message queue for front panel operations errors).

There is a separate SCPI Error queue for each I/O session. Boot-up instrument messages are handled differently. These messages are placed into the error queue of the first I/O session.

*CLS clears all entries in the queue. See *CLS for more information.

Retrieve All Entries In The Queue

Remote command only.

Queries the SCPI Error queue for all unread items and removes them from the queue. The response is a comma separated list of number, string pairs in FIFO order. If the queue is empty, the response is 0,"".

SCPI Command

:SYSTem:ERRor:ALL?

SCPI Example

SYST:ERR:ALL?

Notes When the SCPI Error queue is empty, 0,"" is returned.
Preset N/A

State Saved

No

Initial S/W Revision

A.01.00

Number of Entries In The Queue

Remote command only.

Queries the SCPI Error queue for the number of unread items. As errors and events may occur at any time, more items may be present in the queue at the time it is actually read.

SCPI Command

:SYSTem:ERRor:COUNt?

SCPI Example

SYST:ERR:COUN?

Notes If the queue is empty, 0 is returned.
Preset N/A

State Saved

No

Initial S/W Revision

A.01.00

Retrieve Next Entry

Remote command only.

Queries the SCPI Error queue for the next item and removes it from the queue. The response returns the full queue item consisting of an integer and a string. When the queue is empty, 0,"No error" is returned.

SCPI Command

:SYSTem:ERRor[:NEXT]?

SCPI Example

SYST:ERR?

Notes If the queue is empty, 0,"No error" is returned.
Preset N/A

State Saved

No

Initial S/W Revision

A.01.00

Retrieve Next Entry Code

Remote command only.

Queries the SCPI Error queue for the next item and removes this item from the queue. The response returns only the error code number omitting the string. When the queue is empty, 0 is returned.

SCPI Command

:SYSTem:ERRor:CODe[:NEXT]?

SCPI Example

SYST:ERR:COD?

Notes If the queue is empty, 0 is returned
Preset N/A

State Saved

No

Initial S/W Revision

A.01.00

Message in the Message Queue

Remote command only.

Queries the Message queue and returns the first message which has not been queried/read from this queue. Subsequent query returns the next unread message from the queue, and so on.

SCPI Command

:SYSTem:NOTification?

SCPI Example

:SYST:NOT?

Notes

The response is a comma separated value that consists of:

  • a string representing the timestamp of the message with the format "MM/DD/YYYY<space>HH:MM<space><AM or PM>" in instrument local time. "HH" is 12-hour clock. "<AM or PM>" shows before or after midday by "AM" or "PM".

  • an enum representing the type of message with the enumerations shown below.

    • NONE - Indicates that no unread message is left in the Message queue for the query.

    • INFormation

    • WARNing

    • ERRor

  • a string representing the message.

When all messages have been read from the queue, further queries return: "",NONE,""
Messages related only to the User Interface, such as "Local Operation Resumed", are not returned by this command.
This command only queries and returns the message from the Message queue but does not alter the contents of the Message queue.

Initial S/W Revision

A.16.20

List installed Software Options

Remote command only.

This query returns a comma-separated list of installed software application options. This differs from the output for *OPT? in that the *OPT? lists the installed hardware options.

SCPI Command

:DIAGnostic[:CPU]:INFormation:OPTions?

SCPI Example

:DIAG:INF:OPT?

State Saved

No

Initial S/W Revision

A.01.00

Lock Workstation

Remote command only.

Performs the same functionality as the Win+L function or the "Lock" function on the CTL-ALT-DEL screen in Windows. 

When this command is executed, the computer is immediately locked. The initial login screen appears; no one can access the computer at this point unless they have an account and know the account’s password.

If it fails to initiate, it puts an error in the Windows event log for M9383B/M9384B;

"LockWorkStation - Failed to initiate function"

SCPI Command

:SYSTem:LWSTation

SCPI Example

:SYST:LWST

Notes

The lock remains in effect until someone logs in

State Saved

No

Initial S/W Revision

A.01.00

List SCPI Commands

Remote command only.

Outputs a list of the valid SCPI commands for the currently selected Mode.

SCPI Command

:SYSTem:HELP:HEADers?

SCPI Example

:SYST:HELP:HEAD?

Notes

The output is an IEEE Block format with each command separated with the New-Line character (hex 0x0A)

Initial S/W Revision

A.01.00

Instrument start time

Remote command only.

Determines the instrument application start time.

SCPI Command

:SYSTem:METRics:STIMe?

SCPI Example

:SYST:METR:STIM?

Notes

The return value is a string with the format "YYYY-MM-DD<space>HH:MM:SS", in instrument local time.

Initial S/W Revision

A.01.00

SCPI Version Query

Remote command only.

Returns the SCPI version number with which the instrument complies. The SCPI industry standard changes regularly. This command indicates the version used when the instrument SCPI commands were defined.

SCPI Command

:SYSTem:VERSion?

SCPI Example

:SYST:VERS?

Initial S/W Revision

A.01.00

Attenuator History Query

Remote command only.

For M9383B and M9384B only.

Returns the cumulative number of times that the attenuator has been switched. The subopcode indicates the channel being queried.

SCPI Command

:DIAGnostic[:CPU]:INFormation:CCOunt:ATTenuator[1]|2?

SCPI Example

:DIAG:INF:CCO:ATT?

Notes

For instrument models other than M9383B or M9384B, querying the value returns 0.

Initial S/W Revision

A.01.00

Attenuator Bypass History Query

Remote command only.

Returns the cumulative number of times that the attenuator bypass has been switched. The subopcode indicates the channel being queried.

SCPI Command

:DIAGnostic[:CPU]:INFormation:CCOunt:ATTenuator[1]|2:BYPass?

SCPI Example

:DIAG:INF:CCO:ATT:BYP?

Initial S/W Revision

A.01.00

Power On History Query

Remote command only.

Returns the cumulative number of times the signal generator has been powered–on.

SCPI Command

:DIAGnostic[:CPU]:INFormation:CCOunt:PON?

SCPI Example

:DIAG:INF:CCO:PON?

Initial S/W Revision

A.01.00

On Time History Query

Remote command only.

Returns the cumulative number of hours the signal generator has been on.

SCPI Command

:DIAGnostic[:CPU]:INFormation:OTIMe?

SCPI Example

:DIAG:INF:OTIM?

Initial S/W Revision

A.01.00

Controller BIOS Query

Remote command only.

Returns the CPU’s BIOS version in the format provided by the CPU manufacturer.

SCPI Command

:DIAGnostic[:CPU]:BIOS:VERSion?

SCPI Example

:DIAG:BIOS:VERS?

Notes

Return value is a string of the BIOS version in the format provided by the controller’s manufacturer.

Initial S/W Revision

A.09.00